package com.fy.fyspace.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.fy.fyspace.common.result.PageResult;
import com.fy.fyspace.model.dto.file.FileQueryDTO;
import com.fy.fyspace.model.dto.file.RenameFileDTO;
import com.fy.fyspace.model.dto.file.UploadFileDTO;
import com.fy.fyspace.model.entity.FileInfo;
import com.fy.fyspace.model.vo.file.FileStatisticsVO;
import com.fy.fyspace.model.vo.file.FolderVO;
import com.fy.fyspace.model.vo.user.UserSessionVO;

import java.io.IOException;
import java.util.List;

/**
 * 文件信息服务接口
 */
public interface FileInfoService extends IService<FileInfo> {

    /**
     * 上传文件
     *
     * @param userSessionVO 用户会话信息
     * @param uploadFileDTO 上传文件信息
     * @return 上传结果
     * @throws IOException IO异常
     */
    String uploadFile(UserSessionVO userSessionVO, UploadFileDTO uploadFileDTO) throws IOException;

    /**
     * 文件分页查询
     *
     * @param fileQueryDTO 查询条件
     * @param userSessionVO 用户会话信息
     * @return 分页结果
     */
    PageResult filePageQuery(FileQueryDTO fileQueryDTO, UserSessionVO userSessionVO);

    /**
     * 删除文件
     *
     * @param fileIdList 文件ID列表
     */
    void delFile(String fileIdList);

    /**
     * 重命名文件
     *
     * @param renameFileDTO 重命名信息
     */
    void rename(RenameFileDTO renameFileDTO);

    /**
     * 创建文件下载路径
     *
     * @param fileId 文件ID
     * @return 下载路径
     */
    String createDownloadURL(String fileId);

    /**
     * 创建文件夹
     *
     * @param filePid 父级ID
     * @param fileName 文件夹名称
     * @param userSessionVO 用户会话信息
     * @return 创建的文件夹信息
     */
    FileInfo newFolder(String filePid, String fileName, UserSessionVO userSessionVO);

    /**
     * 获取文件夹信息
     *
     * @param fileIds 文件ID列表
     * @return 文件夹信息列表
     */
    List<FolderVO> getFolderInfo(String fileIds);

    /**
     * 获取所有文件夹
     *
     * @param userSessionVO 用户会话信息
     * @param filePid 父级ID
     * @param currentFileIds 当前文件ID列表
     * @return 文件夹列表
     */
    List<FileInfo> loadAllFolder(UserSessionVO userSessionVO, String filePid, String currentFileIds);

    /**
     * 移动文件到指定文件夹
     *
     * @param fileIds 文件ID列表
     * @param filePid 目标文件夹ID
     */
    void changeFileFolder(String fileIds, String filePid);

    /**
     * 获取文件路径
     *
     * @param fileId 文件ID
     * @return 文件信息
     */
    FileInfo getFilePath(String fileId);

    /**
     * 获取文件统计信息
     *
     * @param id 用户ID
     * @return 文件统计信息
     */
    FileStatisticsVO getFileStatistics(Integer id);

    /**回收站文件分页查询
     *
     * @param ageNo
     * @param pageSize
     * @param userSessionVO
     * @return
     */
    PageResult loadRecycleList(Integer ageNo, Integer pageSize, UserSessionVO userSessionVO);

    /**恢复删除
     *
     * @param fileIdList
     */
    void recoverFile(List<String> fileIdList);

    /**永久删除回收站文件
     *
     * @param delFileList
     * @param userSessionVO
     */
    void delRecycleFile(List<String> delFileList,UserSessionVO userSessionVO);
} 